home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / prog_gen / verpat00.zip / VERPATCH.DOC < prev   
Text File  |  1994-07-16  |  5KB  |  146 lines
  1. Version Patching (C)Copyright 1993 Rob Cohan
  2.  
  3. Here are a pair of programs we use to place version numbers in executable
  4. programs after they're built.  We use them all the time and hope you will
  5. find them useful also.
  6.  
  7. The version patching programs are JokePostcardWare.  To register, send a 
  8. picture postcard with your favorite joke on it, 1000 words or less.
  9.  
  10. Send to:
  11.  
  12. Rob Cohan
  13. PO Box 416
  14. Feasterville, PA 19053-0416
  15.  
  16.  
  17. For Clarion programs, create two fields in the MEMORY file:
  18.  
  19. 1)    MEM:VersionMinor
  20.     The value is the key.  These are ASCII 179, 189, every 10 up to 249.
  21.     Create these by holding down the Alt key, typing 179 on the keypad
  22.     and releasing the Alt key, etc.
  23.     You're creating eight characters even though the string is length
  24.     four (4).
  25. ╔══════════════════════════════════════════
  26. ║                    Field
  27. ║
  28. ║  Field Name :VersionMinor
  29. ║  Description:Target for version patching
  30. ║  Type       :String
  31. ║  Length     :  4
  32. ║  Picture    :@s4
  33. ║  Value      :'│╜╟╤█σ∩∙'
  34.  
  35.  
  36. 2)    mem:VersionMajor
  37. ╔══════════════════════════════════════
  38. ║                    Field
  39. ║
  40. ║  Field Name :VersionMajor
  41. ║  Description:
  42. ║  Type       :String
  43. ║  Length     :  1
  44. ║  Picture    :@s1
  45. ║  Value      :'1'
  46.  
  47.  
  48. Whereever you wish to display the version, build it up from the two 
  49. fields, such as:
  50. ╔════════════════════════════════════════════╗
  51. ║               Computed Field               ║
  52. ║                                            ║
  53. ║  Name        :SCR:version                  ║
  54. ║  Picture     :@s6                          ║
  55. ║  Expression  :mem:versionmajor & '.' & mem:versionminor
  56. ║  Result Field:                             ║
  57. ║  Attribute   :Normal                       ║
  58. ║                                            ║
  59. ╚════════════════════════════════════════════╝
  60. Or,  you can display them separately.
  61.  
  62. Once this is done, you have to touch your .app file only when the major
  63. version number changes (the '2' in 2.0.)
  64.  
  65. Set the Initial Minor Version at the DOS command line using the following
  66. command: (assuming the initial verison in this example is 1.0232)
  67.  
  68.     ECHO 0232 > version
  69.  
  70. Note: the .EXE must be uncompressed for this operation to succeed.  
  71. If you use PKLITE.EXE, it should be used after version patching.  Certain
  72. operations automatically call it, though by its primary name only.  To bypass
  73. this problem, we have included a .COM file named PKLITE which should be copied
  74. into your local directory (where your .APP is) to provide a false target.  It
  75. merely reports the date to the screen.  You can later on explicitly run
  76. PKLITE.EXE by its full name and you will bypass the false target .COM file.
  77. An example is given below.
  78.  
  79. To insert the version number in the final executable, at the DOS command
  80. prompt you can do this, assuming XYZ.EXE is your .EXE name:
  81.  
  82.     INSVER xyz.exe
  83.  
  84. To make the number increment, just type at the DOS prompt:
  85.  
  86.     BUMPVER
  87.  
  88. We use a batch file called NEWVER.BAT in each application subdirectory
  89. constructed as follows:
  90.  
  91.     -------------- NEWVER.BAT, cut here -------------------------
  92.     bumpver
  93.     insver xyz.exe
  94.     pklite.exe -a -o xyz.exe
  95.     -------------- newver.bat, cut here -------------------------
  96.  
  97.  
  98. Sometimes our display of version number is buried in the program in an
  99. "About this program" screen.  When we do this, it is not immediately 
  100. apparent that a certain executable is not version stamped.  On the 
  101. primary menu screen we place a flashing red reminder constructed as
  102. follows:
  103. ╔════════════════════════════════════════════╗▒▒▒▒
  104. ║              Conditional Field             ║▒▒▒▒ NVS stands for 
  105. ║                                            ║▒▒▒▒ non-version-stamped
  106. ║  Name        :SCR:noversion                ║▒▒▒▒
  107. ║  Picture     :@s3                          ║▒▒▒▒ 
  108. ║  Condition   :left(mem:version,4)='│╜╟╤'   ║▒▒▒▒
  109. ║    If True   :'NVS'                        ║▒▒▒▒
  110. ║    If False  :''                           ║▒▒▒▒
  111. ║  Result Field:                             ║▒▒▒▒
  112. ║  Attribute   :Red BLK On Black             ║▒▒▒▒
  113. ╚════════════════════════════════════════════╝▒▒▒▒
  114.  
  115. We hope you enjoy and find use in these programs.  
  116.  
  117.  
  118.                       Disclaimer of Warranty
  119.  
  120. Users of this software must accept this disclaimer of warranty:
  121.  
  122. This software is supplied as is. 
  123.  
  124. Rob Cohan disclaims all warranties, either express or implied, including but 
  125. not limited to implied warranties of merchantability and fitness for a 
  126. particular purpose, with respect to the software and the accompanying 
  127. written materials.
  128.  
  129. No liability for consequential damages. In no event shall Rob Cohan be 
  130. liable for any damages whatsoever (including, without limitation, damages
  131. for loss of business profits, business interruption, loss of business 
  132. information, or other pecuniary loss) arising out of the use of or 
  133. inability to use these products, even if Rob Cohan has been advised 
  134. of the possibility of such damages. Because some states do not allow 
  135. the exclusion or limitation of liability for consequential or incidental 
  136. damages, this software may not be used or licensed in those states.
  137.  
  138.  
  139. File list:
  140.  
  141. INSVER   EXE     11990 07-10-93   8:14p
  142. BUMPVER  EXE     10156 03-11-93   8:01p
  143. PKLITE   COM       325 12-20-91   8:50p
  144. VERPATCH DOC      5163 07-16-94   6:20a
  145.  
  146.